

            NeoTracker v1.4

          Instrukcja  obsugi



 --------------------------------------



   WSTP



   NeoTracker jest programem sucym

do edycji i odtwarzania muzyki przy

pomocy omiobitowych sampli (cyfrowych

prbek dwiku), wykorzystujcym

rozszerzon pami do 1MB oraz COVOX.

Pod wzgldem obsugi wzorowany jest na

najlepszym (najwygodniejszym), zdaniem

autora, programie muzycznym - Theta

Music Composer'ze.

   Od momentu wydania wersji 1.12

mino ju kilka miesicy, od wpisania

pierwszego LDA - dokadnie rok. Dlatego

te, mimo rozpoczcia prac nad wersj

2.0, postanowiem wyda wersj 1.4 -

nie tak bogat w moliwoci, bo opart

czciowo jeszcze na starym kodzie.

   Mimo tego mam nadziej, e wanie

dziki nowej wersji muzyka tworzona

przy pomocy sampli zacznie by trakto-

wana na naszej platformie nieco

powaniej.

   Miego tworzenia yczy



                        Epi/Tristesse

                           28.08.2003





   HISTORIA



   Wersja 1.4 (08.2003)

- zwikszona czstotliwo miksowania

  przy odtwarzaniu moduu (11.5kHz)

- poprawione tablice czstotliwoci

- poprawiona konwersja formatu MOD

- poprawione zarzdzanie pamici

- wbudowana podrczna pomoc

- wybr urzdzenia: POKEY/COVOX przy

  instalacji

- komendy efektu portamento

- obsuga podkatalogw SpartaDOS

- oddzielne cieki dla moduw,

  sampli i paternw

- kilkanacie mniejszych poprawek



   Wersja 1.12p (02.2003)

- odpowiednik wersji 1.12 dla POKEYa



   Wersja 1.12 (12.2002)

- dodana czwarta oktawa przy konwersji

  formatu MOD

- usunite kilka drobnych bdw



   Wersja 1.11 (11.2002)

- niewielkie zmiany w obsudze

- poprawiona obsuga pynnej zmiany

  gonoci

- opcja wygadzania sampli



   Wersja 1.1 (11.2002)

- opcja testowania sampli z klawiatury

  przy czstotliwoci 15.5kHz

- usunite kilka bdw



   Wersja 1.0 (11.2002)

- zupenie nowy wygld, wzorowany na

  TMC

- nowy format pliku

- szybsza i dokadniejsza konwersja

  formatu MOD

- informacja o iloci wolnego miejsca

  na dysku

- moliwo wykorzystania tzw. dugiego

  sampla - do 22kB

- komendy pynnej zmiany gonoci

- kilka mniejszych poprawek



   Wersja 0.91 (10.2002)

- konwersja plikw .MOD (ProTracker)

- drobne zmiany w obsudze



   Wersja 0.9 (09.2002)

- pierwsza wersja





   WYMAGANIA SYSTEMOWE



Konfiguracja sprztowa:



minimalna  - ATARI 130XE

           - stacja dyskw



podstawowa - +256kB RAM

           - Covox

           - stacja dyskw lub SIO2PC



optymalna  - +1MB RAM

           - Covox

           - SpartaDOS X

           - SIO2PC lub twardy dysk



Wymagania programowe:



- MEMLO poniej $2000

- nie uywana pami pod ROM-em OS





   INSTALACJA



   W celu zainstalowania NeoTracker'a

naley przygotowa ok. 16kB wolnego

miejsca na dowolnym dysku oraz wczyta

plik NEOINST.COM. Po jego zaadowaniu

mamy moliwo zmiany nastpujcych

ustawie:



- Katalogi domylne (Default

  directories) dla moduw, sampli

  i paternw. Ustawiane s one

  standardowo przy kadym uruchomieniu

  programu.

  Klawisze:    DEL - cofnicie kursora

           RET,TAB - zatwierdzenie

               ESC - wyjcie do DOS



- Uywane banki pamici dodatkowej

  (Extended memory). Wywietlane

  informacje to: liczba aktywnych

  bankw, cakowita ilo bankw oraz

  (poniej) kody wszystkich aktywnych

  bankw. Kody nieaktywnych (nie

  wykorzystywanych przez NeoTracker'a)

  bankw zastpowane s przez "==".

  Klawisze: -,=,+,* - ruch kursorem

               SPC - aktywacja/

               dezaktywacja banku

           RET,TAB - zatwierdzenie

               ESC - wyjcie do DOS



- Dwik I/O (I/O Sound). Jego

  wyczenie znacznie uprzyjemnia

  odczyt dugich plikw przez SIO.

  Klawisze:    SPC - w-/wyczenie

           RET,TAB - zatwierdzenie

               ESC - wyjcie do DOS



- Urzdzenie wyjciowe (Output device).

  Opcja umoliwia korzystanie z prog-

  ramu na komputerach nie wyposaonych

  w Covox. Stereo jest wykrywane

  automatycznie.

  Klawisze:    SPC - zmiana POKEY/COVOX

           RET,TAB - zatwierdzenie

               ESC - wyjcie do DOS



- cieka docelowa (Save to:) - okrela

  istniejcy katalog, w ktrym zostanie

  zapisany NeoTracker z wybranymi

  ustawieniami.

  Klawisze:    DEL - cofnicie kursora

               TAB - powrt do edycji

                    katalogu domylnego

               RET - instalacja

               ESC - wyjcie do DOS



   Najprostszym sposobem instalacji

(polecanym uytkownikom starszych DOSw

oraz stacji dyskw), jest siedmiokrotne

wcinicie klawisza RETURN, a potem Y.

   Uytkownicy SDX powinni pamita

o koniecznoci podania bezwzgldnych

cieek dostpu oraz wyczeniu banku

wykorzystywanego przez DOS w trybie

BANKED - najczciej jest to drugi

(liczc od zera) wykrywany bank, ale

(dla pewnoci) najlepiej jest uy

sterownika SSDXBNK.SYS, przenoszcego

SDX do wybranego banku.





   PIERWSZE URUCHOMIENIE



   Uruchomienie programu nastpuje po

wczytaniu NEO.COM. Po zaadowaniu

nastpuje rozpakowanie i generacja

tablic, po czym ukazuje si gwny

ekran. Dzieli si on na trzy najwa-

niejsze czci: edytor paternw

(po lewej), edytor songu (po prawej, na

grze) oraz okno sampli (rwnie po

prawej, ale na dole). Przechodzenie

midzy oknami dokonuje si klawiszem

[TAB].

   Poniej znajduj si jeszcze trzy

mniejsze okienka, informujce kolejno

o: szybkoci odtwarzania caego moduu,

biecej oktawie oraz statusie ostat-

niej operacji. Normalnie wywietlana

jest tu informacja o iloci wolnych

bankw rozszerzonej pamici dla sampli

(jeden sampel zajmuje jeden bank) oraz

rozmiarze wolnej pamici na paterny

(w bajtach). Oprcz tego, tu pod

informacj o wersji programu i autorze,

znajduje si miejsce na tytu aktualnie

wczytanego utworu.

   Wszystkie liczby w programie (za

wyjtkiem numeru bdu) podawane s

w notacji szesnastkowej.

Maksymalna liczba paternw wynosi 128,

a sampli - 64, przy czym w duej mierze

zaley to od iloci wolnej pamici.

Zapenienie bufora dla paternw lub

wszystkich bankw rozszerzonej pamici

dla sampli powoduje wywietlenie

komunikatu "Out Of Memory". Dugo

sampli ograniczona jest rozmiarem

banku (16kB), ale istnieje moliwo

uycia jednego sampla o dugoci do

22kB ($5800).

   Czstotliwo odtwarzania wynosi:

- przy odgrywaniu moduu - 11.5kHz

  (o 0.4kHz wicej, ni w poprzednich

  wersjach)

- przy testowaniu sampli/odgrywaniu

  paternu - 15.5kHz

- przy wpisywaniu nut z klawiatury

  - ok. 13kHz



   Rozkad klawiszy nutowych jest

nastpujcy:



Pierwsza oktawa:

   [S] [D]     [G] [H] [J]     [L]

 [Z] [X] [C] [V] [B] [N] [M] [,] [.]



Druga oktawa:

   [2] [3]     [5] [6] [7]     [9]

 [Q] [W] [E] [R] [T] [Y] [U] [I] [O]



   Program dysponuje zakresem ponad

piciu oktaw (63 ptony).



   Przy komponowaniu utworu mona

korzysta z nastpujcych efektw:

- koniec paternu - tu za pozycj

  w paternie, gdzie jest umieszczony,

  powoduje zakoczenie odgrywania

  biecego paternu/pozycji w songu

  i zaptlenie paternu/przejcie do

  nastpnej pozycji w songu

- zmiana tempa - umoliwia zmian szyb-

  koci odtwarzania utworu w dowolnym

  momencie jego trwania od pozycji

  w paternie, na ktrej zostanie

  ustawiona

- pynna zmiana gonoci - powoduje

  zwikszanie lub zmniejszanie go-

  noci co jedn ramk - na pozycji,

  w ktrej jest umieszczona, wykonuje

  si tyle razy, ile okrela to aktual-

  na szybko odtwarzania

- portamento (pynna zmiana wysokoci

  dwiku) - warto parametru dodawana

  jest do czstotliwoci dwiku na

  danym kanale, naley pamita

  o obowizujcej tutaj skali logary-

  tmicznej; niestety - ze wzgldu na

  rne czstotliwoci odtwarzania

  paternu i caego utworu, dobr

  odpowiednich wartoci moe sprawia

  problemy



   Tablica gonoci obejmuje zakres

33 rnych gonoci - od $00 (cisza)

do $20 (pena gono sampla).



   Od wersji 0.91 moliwy jest import

moduw w formacie MOD (ProTracker).

Konwersja obejmuje nuty w czterech

oktawach oraz efekty: 1,2 (portamento;

niestety bez uwzgldnienia odwrconej

skali logarytmicznej i tylko do

wartoci $0F), 5,6,A (pynna zmiana

gonoci), B (skok do pozycji),

C (zmiana gonoci), D (koniec

paternu). Z grubsza konwersja polega

na zamianie sampli ze znakiem na prbki

bez znaku, podzieleniu gonoci przez

2 (format MOD przewiduje 65 poziomw

gonoci), oraz podzieleniu paternw

czterociekowych na pojedyncze cieki

i spakowaniu ich.





   EDYTOR PATERNW



   Na szczycie okna widnieje skrtowa

informacja o biecym paternie: jego

numer oraz znak "+" lub "-", mwicy

o tym, czy w danym paternie co si

znajduje. "-" oznacza patern pusty.

   Poniej znajduje si 17 z 64 linii

paternu - kada z nich wyglda

mniej-wicej tak:



            1E:>D#2 04 20 P5

            ----------------

            aa:znnn ss vv kp



gdzie: aa - numer linii w paternie

        z - w tym miejscu moe sta

            znacznik, uywany np. przy

            kopiowaniu fragmentw

            paternu

      nnn - nuta odgrywana na danej

            pozycji, lub puste miejsce

            oznaczajce kontynuacj

            odgrywania poprzedniej nuty

       ss - numer sampla uytego do

            odegrania danej nuty - jego

            brak oznacza kontynuacj

            odtwarzania poprzedniego

            sampla

       vv - zmiana gonoci

       kp - komenda efektu i parametr:

            S0 - koniec paternu

            Sx - zmiana tempa (x=1-F)

            -x - pynne ciszanie

            +x - pynne poganianie

            Qx - portamento w d

            Px - portamento w gr



   Klawisze w edytorze paternw:

(^ = [CTRL], ! = [SHIFT])



klawisze nutowe - wpisywanie nut

[-][=] - ruch kursorem: gra/d

![INS] - wstawienie pustej linii

![DEL] - usunicie linii

[DEL]  - kopiowanie zaznaczonej pozycji

^[Z]   - ustawienie znacznika

![P]   - skok na pocztek paternu

^[P]   - skok do pozycji znacznika



![-][=] - wybr oktawy

^[-][=] - wybr biecego sampla

 [+][*] - wybor paternu: poprzedni/

          nastpny

^[Q]    - skok do wybranego paternu



 ![<]  - wyczyszczenie paternu

 ^[<]  - skopiowanie paternu do bufora

         i wyczyszczenie paternu

 ^[>]  - skopiowanie zawartoci bufora

         do paternu

!^[>]  - naoenie zawartoci bufora na

         biecy patern

 ^[L]  - odczyt paternu

 ^[S]  - zapis paternu

 [RET] - odtwarzanie paternu

![RET] - odtwarzanie od pocztku

^[RET] - odtwarzanie od pozycji

         znacznika

         ([SPC] - stop)



 ^[C]    - zmiana gonoci na biecej

           pozycji

 ![+][*] - zmiana gonoci stopniowo:

           ciszej/goniej

 ^[,][.] - ustawienie komendy efektu

 ^[+][*] - zmiana parametru komendy

 ![SPC]  - usunicie komendy efektu

 ^[SPC]  - usunicie numeru sampla

 ^[N]    - zmiana tytuu utworu

!^[-][=] - zmiana tempa caego utworu



   Ponisze cztery opcje uruchamia si

z klawiszem [CTRL] (edycja numeru

sampla) lub [SHIFT] (edycja parametru,

nie przy kasowaniu - [D]). Klawisze [+]

i [*] su do wyboru wpisywanej

wartoci (szesnastkowo), [RET] powoduje

zatwierdzenie wpisu, [ESC] - rezygnacj

i powrt do edycji paternu.



[T] - transpozycja - warto parametru

      okrela, o ile ptonw zostan

      podniesione dwiki

[X] - zmiana sampli - warto parametru

      okrela numer sampla docelowego

[V] - zmiana gonoci - parametr

      jest mnoony przez gono

      na kadej pozycji w paternie

      wedug zasady: $40 - *2, $20 -

      *1, $10 - *0.5, itd.

[D] - kasowanie nut - wyczyszczenie

      wszystkich pozycji, na ktrych

      uyto wybranego sampla



  [TAB] - przejcie do okna sampli

 [HELP] - pomoc

!^[ESC] - wyjcie do DOS





   OKNO SAMPLI



   W oknie tym znajduje si lista

wczytanych sampli, kada linia tej

listy wyglda mniej-wicej tak:



        >+04:!MINOR CHORD [L]

        ----------------------

        zuaa:lnnnnnnnnnnnnnnnn



gdzie: z - znacznik wskazujcy biecy

           sampel (uywany do odgry-

           wania i wpisywania nut)

       u - znak "+" w tym miejscu

           oznacza, e dany sampel jest

           uywany w biecym paternie

      aa - numer sampla

       l - znak "!" w tym miejscu

           stoi przed nazw dugiego

           (ponad 16kB) sampla

  nnn... - nazwa sampla



   Po prawej stronie znajduje si wska

kolumna, z ktrej mona odczyta

informacje o biecym samplu:

SMP - numer sampla

VOL - gono bazowa

LEN - dugo sampla w bajtach

REP - pozycja pocztku ptli



   Klawisze w oknie sampli:



 [-][=] - wybr sampla

   ^[Q] - skok do wybranego sampla

![-][=] - wybr oktawy

 [RET]  - testowanie sampla

          ([SPC] - stop)

^[V]    - zmiana gonoci bazowej

![+][*] - stopniowa zmiana gonoci

          bazowej

^[S]    - zapis sampla .NSF

^[L]    - odczyt sampla .NSF

^[R]    - odczyt sampla .SMP

          (z programu ProTracker)

^[D]    - usunicie sampla z listy

^[N]    - zmiana nazwy sampla



  [TAB] - przejcie do edytora songu

 [HELP] - pomoc

!^[ESC] - wyjcie do DOS





   EDYTOR SONGU



   Na samej grze okna znajduje si

informacja o numerach cieek oraz

ich stan: podkrelenie pod nazw

cieki oznacza kana wczony.

   Poniej wida fragment (8 linii)

songu, kada z tych linii wyglda

mniej-wicej tak:



       01 1E:00 1E:0C 04:00 0A:FE

       --------------------------

       aa p1:t1 p2:t2 p3:t3 p4:t4



gdzie: aa - numer linii

       px - numer paternu na danej

            pozycji na ciece nr x

       tx - transpozycja paternu na

            danej pozycji na ciece x



   Klawisze w edytorze songu:



[-][=][+][*] - ruch kursorem

 ^[Q]    - skok do wybranej pozycji

  [0..F] - wpisywanie wartoci

 ![1..4] - w-/wyczenie cieki

!^[-][=] - zmiana tempa utworu

  [RET]  - odtwarzanie moduu

 ![RET]  - odtwarzanie od pocztku

 ^[SPC]  - zerowanie wartoci pod

           kursorem

 ^[N]    - edycja tytuu utworu

 ^[L]    - odczyt moduu .NEO

 ^[R]    - import moduu .MOD

 ^[S]    - zapis moduo .NEO

!^[CLR]  - skasowanie wszystkich

           danych



  [TAB] - przejcie do edytora paternw

 [HELP] - pomoc

!^[ESC] - wyjcie do DOS





   OPERACJE DYSKOWE



   Kada prba odczytu lub zapisu

danych w NeoTrackerze powoduje przej-

cie do menu operacji dyskowych. Na

dole ekranu pojawia si wtedy cieka

dostpu do biecego katalogu,

a w oknie paternu widoczna jest jego

zawarto - pliki danego typu oraz

podkatalogi. Program obsuguje zarwno

katalogi MyDOS-a, jak i SpartaDOS.

Jeeli katalog jest pusty, widoczna

jest tylko informacja "no files". Wpis

".." oznacza katalog nadrzdny.



Klawisze przy odczycie pliku:



  [-][=] - ruch kursorem

   [RET] - wejcie do podkatalogu/

           odczyt pliku

!^[1..8] - przejcie do katalogu

           gwnego danego dysku



Klawisze przy zapisie pliku:



[A..Z][0..9][_] - edycja nazwy

   [DEL] - kasowanie znaku

  [-][=] - ruch kursorem

   [RET] - wejcie do podkatalogu

  ![RET] - zapis pliku o podanej nazwie

  ^[RET] - utworzenie podkatalogu

           o podanej nazwie

  ![DEL] - usunicie podkatalogu (tylko

           MyDOS) lub pliku

!^[1..8] - przejcie do katalogu

           gwnego danego dysku



   Jeeli podczas odczytu/zapisu

wystpi bd, zostanie wywietlona

odpowiednia informacja. Komunikat "I/O

Error- nnn!" oznacza bd transmisji

(nnn to jego numer), za "Bad file

type", e nie zosta poprawnie roz-

poznany format pliku.





   KREDYTKI



   Program powsta przy wspudziale

nastpujcych osb:



- pomys, projekt, kod, testowanie,

  dokumentacja:

   Epi/Tristesse^O.S.



- pomys, testowanie:

   Pinokio/Tristesse



- procedura wykrywajca XMS:

   Fox/Taquart



Przy jego tworzeniu przyday si

nastpujce programy:

- X-Assembler v2.5          Fox/Taquart

- Turbo Basic XL 1.5    Frank Ostrowski

- MS-Edit v2.0                Microsoft

- APE 1.16             Steven J. Tucker

- QMEG v4.3     S. Dorndorf, Gumi/Tight

- Flash Pack v2.1           Fox/Taquart

- FastTracker v2.09   Vogue&Mr.H/Triton



   Specjalne podzikowania dla

Voy-a/SSG^Dial za mas inspirujcych

informacji o tracker-ach z innych

platform.



   NeoTracker v1.4 jest programem typu

freeware, co oznacza, e:

- uywasz go na wasn odpowiedzialno

- rozpowszechniasz go nie zmieniajc

  nic w archiwum i nie biorc za niego

  adnej zapaty

- nic za niego nie pacisz, ale jeeli

  Ci si on spodoba, jeste zobowizany

  wysa autorowi pocztwk ze swojej

  miejscowoci



   Wszelkie sensowne uwagi i propozycje

oraz kartki pocztowe naley kierowa

na adres autora:



        snail: Adrian Matoga

               ul. Jedziecka 11

               30-698 Krakw

       e-mail: epi@atari.pl

          gsm: +48505713863



 --------------------------------------



          (c) 2003 Tristesse



